home *** CD-ROM | disk | FTP | other *** search
/ Aminet 3 / Aminet 3 - July 1994.iso / Aminet / disk / misc / Mtools207.lha / Mtools-2.0.7 / docs / Mtools.doc < prev    next >
Encoding:
Text File  |  1994-05-27  |  3.0 KB  |  75 lines
  1.  
  2. NAME
  3.        Mtools  -  a  collection  of  tools for manipulating MSDOS
  4.        files
  5.  
  6. SYNOPSIS
  7.        mattrib - change MSDOS file attribute flags
  8.        mcd - change MSDOS directory
  9.        mcopy - copy MSDOS files to/from Unix
  10.        mdel - delete an MSDOS file
  11.        mdir - display an MSDOS directory
  12.        mformat - add an MSDOS filesystem to a low-level formatted diskette
  13.        mlabel - make an MSDOS volume label
  14.        mmd - make an MSDOS subdirectory
  15.        mrd - remove an MSDOS subdirectory
  16.        mread - low level read (copy) an MSDOS file to Unix
  17.        mren - rename an existing MSDOS file
  18.        mtype - display contents of an MSDOS file
  19.        mwrite - low level write (copy) a Unix file to MSDOS
  20.  
  21. DESCRIPTION
  22.        Mtools is a public domain collection of programs to  allow
  23.        Unix  systems  to  read, write, and manipulate files on an
  24.        MSDOS filesystem (typically  a  diskette).   Each  program
  25.        attempts  to  emulate  the  MSDOS  equivalent  command  as
  26.        closely as practical.
  27.  
  28.        MSDOS filenames are optionally composed of a drive  letter
  29.        followed by a colon, a subdirectory, and a filename.  Sub-
  30.        directory names can use either the '/' or  '\'  separator.
  31.        The use of the '\' separator or wildcards will require the
  32.        names to be enclosed in quotes to protect  them  from  the
  33.        shell.
  34.  
  35.        The  regular expression "pattern matching" routines follow
  36.        the Unix-style rules.  For example, '*' matches all  MSDOS
  37.        files  in  lieu  of '*.*'.  The archive, hidden, read-only
  38.        and system  attribute  bits  are  ignored  during  pattern
  39.        matching.
  40.  
  41.        Not all Unix filenames are appropriate in the MSDOS world.
  42.        The Mtools commands may have to alter Unix  names  to  fit
  43.        the  MSDOS filename restrictions.  Most commands have a -v
  44.        (verbose) option that will display the new names  if  they
  45.        have  been  changed.  The following table shows some exam-
  46.        ples of filename conversions:
  47.  
  48.             l l  l.   Unix  name MSDOS  name     Reason  for  the
  49.             change  _    _    _ thisisatest    THISISAT  filename
  50.             too long emmet.gray     EMMET.GRA extension too  long
  51.             prn.txt   XRN.TXT   PRN     is    a    device    name
  52.             hot+cold  HOTXCOLD  illegal character
  53.  
  54.        All options use the '-' (minus) flag,  not  '/'  as  you'd
  55.        expect in MSDOS.
  56.  
  57.        The  mcd  command  is used to establish the device and the
  58.        current working directory (relative to the MSDOS  filesys-
  59.        tem), otherwise the default is assumed to be A:/.
  60.  
  61.        All  the  Mtools  commands return 0 on success, 1 on utter
  62.        failure, or 2 on partial failure.
  63.  
  64. SEE ALSO
  65.        mattrib(1), mcd(1), mdel(1), mformat(1), mrd(1),  mren(1),
  66.        mtype(1),  mcopy(1), mdir(1), mlabel(1), mmd(1), mread(1),
  67.        mwrite(1)
  68.  
  69. BUGS
  70.        An unfortunate side effect  of  not  guessing  the  proper
  71.        device (when multiple disk capacities are supported) is an
  72.        occasional error message from the  device  driver.   These
  73.        can be safely ignored.
  74.  
  75.